home *** CD-ROM | disk | FTP | other *** search
/ Palm Utilities / Palm_Utilities_CD-ROM_2001_2001.iso / files / utils sync / Yanoff Java Conduit 09.11 / yancond-0.9.11.exe / _SETUP.1 / Readme < prev    next >
Encoding:
Text File  |  2000-04-10  |  3.8 KB  |  92 lines
  1. General
  2. -------
  3. This is an attempt to a conduit for the Yanoff news reader for the Palm OS
  4. (Palm Pilot). The conduit works in combination with HotSync 3.0 and
  5. Yanoff v1.4.2b. You need quite a lot of development tools (see below) since
  6. this conduit is written in Java and uses a Unix-like development 
  7. environment (Cygwin), while Windows 95/NT is used as a development platform.
  8.  
  9. IF you don't plan to recompile, you only need Yanoff 1.4.2b and JSync. JSync
  10. is part of the CDK-J, but can also be downloaded from the conduit web site.
  11.  
  12. See the COPYRIGHT and COPYING files for details on licensing terms and 
  13. (the absence of) warranty. See the HISTORY file for version history.
  14.  
  15. The most recent version of this package can be found at
  16. http://www.sepa.tudelft.nl/webstaf/janb/yanoff/index.html
  17.  
  18. Needed tools (development only)
  19. -------------------------------
  20. Of course you need Yanoff itself, from
  21. http://www.free.de/mjordan/yanoff/yanoff.html
  22. For this conduit, you need version 1.4.2b from the
  23. conduit web site. 1.4.2 will crash!
  24.  
  25. You need a recent Java Development Kit, such as jdk-1.1.8 from Sun. 
  26. Download from http://www.javasoft.com/products/jdk/1.1/
  27.  
  28. The Makefile is for the Cygnus Solutions CygWin GNU environment for
  29. Windows 95/NT. 
  30. Download from http://sourceware.cygnus.com/cygwin/download.html 
  31.  
  32. You need the JSync Java synchronisation runtime from Palm computing, 
  33. buried in the "Conduit Development Kit - Java". 
  34. Download from http://www.palm.com/devzone/cdkjava/cdkjava.html 
  35.  
  36. Directories
  37. -----------
  38. The Java source files are in the src/ directory. To make things complicated, 
  39. the class files (Java bytecode) are in the Java/ directory.
  40.  
  41. Installation
  42. ------------
  43. Quickest installation instructions:
  44. 0. Install Yanoff
  45. 1. Install JSync
  46. 2. Install the conduit using the .zip-file distribution
  47. 3. Restart the HotSync Manager
  48. 4. Try it, and mail me bug-reports!
  49.  
  50. Quick installation instructions:
  51. 0. Install Yanoff ;-)
  52. 1. Install the CDKJ
  53. 2. In the directory you installed the CDKJ in, there is a subdirectory called
  54. JSync Installer. Install the JSync runtime from here.
  55. 3. Unpack the yancond archive.
  56. 4. Use the instructions from the CDKJ to instruct HotSync to use your
  57. brand-new Yanoff conduit. You need to run CondCfg.exe from the CDKJ. 
  58. Add a conduit with creator ID "MJyf", class name 
  59. "palm.conduit.yanoff.YanoffConduit" and class path of the form PATH1;PATH2
  60. where PATH1 is the path you installed yancond, appended with "\java" and
  61. where PATH2 is the path you installed yancond, appended with "\NetComponents.jar".
  62. In my setup, the classpath is 
  63. "d:\java\yancond\java;d:\java\yancond\NetComponents.jar"
  64. 5. Restart the HotSync Manager
  65. 6. Try it, and mail me bug-reports!
  66.  
  67. Full installation instructions (if you want to hack the conduit source):
  68. 0. Install Yanoff ;-)
  69. 1. Install the JDK
  70. 2. Install Cygnus Solution's CygWin 
  71. 3. Install the CDKJ
  72. 4. In the directory you installed the CDKJ in, there is a subdirectory called
  73. JSync Installer. Install the JSync runtime from here.
  74. 5. Unpack the yancond archive, if you haven't already.
  75. 6. Edit the Makefile. Set the paths in the first couple of lines
  76. 7. do "make"
  77. 8. If you're daring, type "make install" to insert the settings into the registry
  78. Else, you need to run CondCfg.exe from the CDKJ. Add a conduit with creator 
  79. ID "MJyf", class name "palm.conduit.yanoff.YanoffConduit" and class path of 
  80. the form PATH1;PATH2 where PATH1 is the path you installed yancond, appended 
  81. with "\java" and where PATH2 is the path you installed yancond, appended 
  82. with "\NetComponents.jar". In my setup, the classpath is 
  83. "d:\java\yancond\java;d:\java\yancond\NetComponents.jar"
  84. 9. Restart HotSync Manager
  85. 10. Try it, and mail me bug-reports!
  86.  
  87. Author
  88. ------
  89. This software is written by Jan-Pascal van Best.
  90. Reach the author at janb@sepa.tudelft.nl
  91.  
  92.